
 CommandBASIC
~~~~~~~~~~~~~~
Program		CmmndBASIC
Purpose		This module allows BASIC statements to be executed from the
		command line
Version		0.02, Friday the 26th of October, 1995
Author		Paul Clifford
Copyright	(C) Paul Clifford 1995
Licence		GPL


 About
=======

This module allows BASIC statements to be executed from the command line, by
using two * commands:
    *{ tokenises and adds the statement to memory
    *} adds a final line (if provided) and executes the statements in memory

Individual statements can be entered by using *}, eg:
    *} SYS "OS_SerialOp",5,17
    *} INPUT a$:OSCLI"Set Input$String "+a$

Alternatively, programs can be built up using *{ and *}, eg:
    *{ MODE 15
    *{ FOR colour% = 0 TO 63
    *{   COLOUR colour%
    *{   PRINT ":";colour%;
    *} NEXT

Each statement is tokenised and then added to a chunk of RMA, which is
increased as needed, 4K at a time. Once the statement(s) have been executed
using *}, the memory is released again.

If you want to place CommandBASIC in a boot sequence, make sure it is loaded
after anything that changes the address of the BASIC module, such as an
RMFaster command or a soft-loaded copy of the module. CommandBASIC finds the
address of BASIC's tokenising routine when it initialises, and if this
changes afterwards it will not work correctly.

